home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / disk / fill311.zip / FILL.DOC < prev    next >
Text File  |  1993-11-07  |  9KB  |  188 lines
  1. FILL.DOC
  2. 11/07/93
  3.  
  4. The FILL program is designed to help you move or copy files off a hard disk
  5. while reducing the amount of wasted space on the destination disks.  Internally,
  6. it does this by sorting the file names so the largest files are moved/copied
  7. first.  It then moves or copies whatever files can fit on the floppy, skipping
  8. any that can't.
  9.  
  10. It can also be used to fill up space on hard disks which is sometimes useful for
  11. network transfers.  It can also be used to split up large files (files bigger
  12. than the output disk size) into segments which can fit.
  13.  
  14. The utility will also label the output disks and create a status report showing
  15. what was moved/copied if desired.
  16.  
  17. Some of the default values for this routine can be set using the CONFIGWS.EXE
  18. program contained in FILLymm.ZIP.
  19.  
  20.  
  21. Syntax:
  22.  
  23.     FILL [ source-filespec ] [ dest-drive: | dest-drive:\path\ ]
  24.       [ /MOVE | /COPY ] [ /PROMPT | /-PROMPT ]
  25.       [ /OVERWRITE | /-OVERWRITE | /OVERSKIP | /OVERASK ]
  26.       [ /Ox | /O-x ] [ /Xfilespec ]... [ /WIPE | /-WIPE ] [ /MULTI | /SINGLE ]
  27.       [ /SPLIT ] [ /LABEL=label [ /START=n ] ] [ /Ffilespec [ /S+ | /S- | S* ]
  28.       [ /BEEP | /-BEEP ] [ /Q ] [ /? ]
  29.  
  30. where:
  31.  
  32. "source-filespec" is the file specification for what you want to move.  You can
  33. specify a drive and path and file wildcards if necessary (e.g.  "C:\TEMP\*.BAT")
  34. but otherwise it defaults to your default drive and directory and takes "*.*".
  35. Note that the program cannot handle any request for more than 500 files at a
  36. time.
  37.  
  38. "dest-drive:" or dest-drive:\path" tells the routine what drive or path to move
  39. the files to.  Typically defaults to "A:\" but is CONFIGWS-able.
  40. In many cases, the routine doesn't really care whether the source
  41. specification precedes or follows the destination specification.  If either
  42. parameter ends with a colon (e.g.  "A:") or slash (e.g.  "C:\QB45\"), the
  43. routine will presume that's the destination specification and the other one must
  44. be the source specification.  If either parameter contains a wildcard, the
  45. routine will presume that's the source specification and the other one must be
  46. the destination specification.  So "FILL A:  *.BAS" is the same as "FILL *.BAS
  47. A:".
  48.  
  49. "/MOVE" says to move the files instead of copying them.  This is typically the
  50. default but is CONFIGWS-able.
  51.  
  52. "/COPY" says to copy the files instead of moving them.
  53.  
  54.  
  55. "/PROMPT" says to prompt for each filename before moving it.
  56.  
  57. "/-PROMPT" says to not prompt for each file.  This is normally the default but
  58. this can be changed using the CONFIGWS.EXE program.
  59.  
  60. "/OVERWRITE" says to overwrite same-named files in the destination path.
  61.  
  62. "/-OVERWRITE" says to abort if any same-named files are found in the destination
  63. path.
  64.  
  65. "/OVERSKIP" says to skip any file that already exists in the destination path.
  66. The counts aren't accurate in this case.  This is typically the default but it's
  67. CONFIGWS-able.
  68.  
  69. "/OVERASK" says to prompt if same-named files exist in the destination
  70. directory.
  71.  
  72. "/Ox" and "/O-x" allow you to specify the copy order for the files.  "x" can be
  73. one of the following:
  74.  
  75.         N = file name
  76.         D = file date and time
  77.         S = file size
  78.  
  79. If you precede the "x" with a dash ("-"), the sort will be done in reverse
  80. order.  Note that this parameter does not determine which files are copied;
  81. it only determines what order they are actually copied.  Since the order that
  82. the file tends to show up in a DOS DIR listing is based on creation order, this
  83. sequence may be relevant to how the files ultimately show up.  Defaults to /O-S
  84. but this can be changed using the CONFIGWS.EXE program.
  85.  
  86. "/Xfilespec" says to exclude certain filespecs from being moved.  You can
  87. specify up to 10 exclusion parameters but each must have their own /Xfilespec
  88. statement.  For example, to move all files except those with a BAS extension,
  89. you could say "FILL /X*.BAS".
  90.  
  91. "/WIPE" says that if the destination drive has files on it, prompt the user
  92. for whether these files should be deleted or not.
  93.  
  94. "/-WIPE" reverses /WIPE.  This is normally the default but this can be changed
  95. using the CONFIGWS.EXE program.
  96.  
  97. "/MULTI" says to go to a second disk if all of the files can't fit on the
  98. first diskette.  This is typically the default but it's CONFIGWS-able.
  99.  
  100. "/SINGLE" says process only one diskette at a time and to not prompt for the
  101. next diskette once the first gets filled up.
  102.  
  103.  
  104. "/SPLIT" says to split up large files which otherwise would not be able to fit
  105. onto the output disk.  For example, /SPLIT is useful when you have a 1.8MB file
  106. that you're trying to copy or move to a 1.2MB or 1.44MB diskette.  Files are
  107. split only if an empty diskette in the output destination would not be able to
  108. support the file; it will not split up a 800KB file just because the 1.2MB
  109. output diskette only has 600KB free.  Files will be given the extensions of
  110. .001, .002, etc until all necessary splitting is accomplished.  To put them back
  111. together again, use COPY with the /B option (e.g. "COPY TEST.001/B+TEST.002/B
  112. TEST.ZIP").
  113.  
  114. "/LABEL=label" specifies the volume label to be written to the output disk.
  115. By default, the label is not changed.  The label can be a quoted mixed-case
  116. string.  It can contain several replacable lowercase only parameters: "mm" is
  117. replaced with the two-digit month, "dd" is replaced with the two-digit day, "yy"
  118. is replaced with the two-digit year, and "n" or "nn" or "nnn" is replaced by the
  119. sequence number of the disk.  All numeric fields are padded to the left with
  120. zeroes as necessary.  If the current date is November 7, 1993:
  121.  
  122.         /LABEL="BKyymmdd nn"
  123.  
  124. will label the first first "BK931107 01", the second disk "BK931107 02" etc.
  125. Note that labels can be no longer than 11 characters in length.  All characters
  126. except the replacable parameters will be translated to uppercase characters.
  127.  
  128. "/START=n" specifies the first sequence number to use in place of "n", "nn", or
  129. "nnn" in the /LABEL parameter.  Defaults to /START=1.
  130.  
  131. "/Ffilespec" specifies the name of a status file to be used.  This status file
  132. is a text file that reports on what's been processed by the program.  If it
  133. exists already, the status file is appended to, not overwritten.  A sample of
  134. some lines from the status file using the /S* option (which is not the default):
  135.  
  136.   FILL results for  /copy *.exe /ftest.txt /beep /wipe /s* /split
  137.   Being run on 11-07-1993 at 17:58:10
  138.  
  139.   Label        FileName    Date     Time                Size Operation
  140.  
  141.   TEST93 #01   AV.EXE       09/29/93 00:50:58          70,282 SKIP
  142.   TEST93 #01   BC.EXE       08/19/92 23:59:00         150,562 SKIP
  143.   TEST93 #01   BFIND.EXE    08/02/93 23:07:08          60,016 SKIP
  144.   TEST93 #01   VBDOS.EXE    08/19/92 23:59:00         555,520 COPY
  145.  
  146.   BRUCE        AV.EXE       09/29/93 00:50:58          70,282 SKIP
  147.   BRUCE        BC.EXE       08/19/92 23:59:00         150,562 SKIP
  148.   BRUCE        BFIND.EXE    08/02/93 23:07:08          60,016 SKIP
  149.  
  150.  
  151. "/S+" specifies that the only files to be written to the status file are those
  152. files that actually get copied/moved.  This is the default.
  153.  
  154. "/S-" specifies that the only files to be written to the status file are those
  155. files that did not get copied/moved.  Since the skipping is determination is
  156. done with each disk, the status file may show the same file name as "SKIP" over
  157. and over again.
  158.  
  159. "/S*" specifies that the status report should contain all files copied/moved as
  160. well as skipped.  This can be a huge report.
  161.  
  162. "/BEEP" says to beep once the routine is done doing its thing.  It will also
  163. beep whenever it's time to stick in a new diskette.
  164.  
  165. "/-BEEP" says to not beep upon completion.  This is normally the default but
  166. this can be changed using the CONFIGWS.EXE program.
  167.  
  168. "/Q" turns off the file-by-file status reporting.
  169.  
  170. "/?" or "/HELP" or "HELP" gives you the syntax of the command.
  171.  
  172. This program was written by Bruce Guthrie of Wayne Software.  It is free for use
  173. provided relevant documentation is kept with the program, no changes are made to
  174. the program or documentation, and it is not bundled with commercial programs or
  175. charged for separately.  People who need to bundle it in for-sale packages must
  176. pay a $50 registration fee to "Wayne Software" at the following address.
  177. Comments and suggestions can also be sent to:
  178.  
  179.                 Bruce Guthrie
  180.                 Wayne Software
  181.                 113 Sheffield St.
  182.                 Silver Spring, MD 20910
  183.  
  184.                 fax: (301) 588-8986
  185.  
  186. Foreign users:  Please provide an Internet address in all correspondence.
  187.  
  188.